---
id: activity
title: tctl v1.17 activity command reference
sidebar_label: activity
description: Experience the new Temporal CLI public preview for streamlined Workflow and Activity management. Utilize tctl commands like `complete` and `fail` with various modifiers for precise control.
toc_max_heading_level: 4
keywords:
  - cli
  - cli reference
  - tctl
  - temporal
  - temporal cli
  - temporal server
---

:::info Temporal CLI is now available

The public preview of [Temporal CLI](/cli) is now available.
We encourage you to begin using it and to provide feedback.

After the release of Temporal CLI v1.0, tctl will deprecate.

:::

The `tctl activity` commands enable [Activity Execution](/activities#activity-execution) operations.

- [tctl activity complete](#complete)
- [tctl activity fail](#fail)

## complete

The `tctl activity complete` command completes an [Activity Execution](/activities#activity-execution).

`tctl activity complete <modifiers>`

The following modifiers control the behavior of the command.

### --workflow_id

Specify the [Workflow Id](/workflows#workflow-id) of an [Activity Execution](/activities#activity-execution) to complete.

Alias: `-w`

**Example**

```bash
tctl activity complete --workflow_id <id>
```

### --run_id

Specify the [Run Id](/workflows#run-id) of an [Activity Execution](/activities#activity-execution) to complete.

Alias: `-r`

**Example**

```bash
tctl activity complete --run_id <id>
```

### --activity_id

Specify the [Activity Id](/activities#activity-id) of an [Activity Execution](/activities#activity-execution) to complete.

**Example**

```bash
tctl activity complete --activity_id <id>
```

### --result

Specify the result of an [Activity Execution](/activities#activity-execution) when using tctl to complete the Activity Execution.

**Example**

```bash
tctl activity complete --result <value>
```

### --identity

Specify the identity of the operator when using tctl to complete an [Activity Execution](/activities#activity-execution).

**Example**

```bash
tctl activity complete --identity <value>
```

## fail

The `tctl activity fail` command fails an [Activity Execution](/activities#activity-execution).

`tctl activity fail [<modifiers>]`

The following modifiers control the behavior of the command.

### --workflow_id

Specify the [Workflow Id](/workflows#workflow-id) of an [Activity Execution](/activities#activity-execution) to fail.

Alias: `-w`

**Example**

```bash
tctl activity fail --workflow_id <id>
```

### --run_id

Specify the [Run Id](/workflows#run-id) of an [Activity Execution](/activities#activity-execution) to fail.

Alias: `-r`

**Example**

```bash
tctl activity fail --run_id <id>
```

### --activity_id

Specify the [Activity Id](/activities#activity-id) of an [Activity Execution](/activities#activity-execution) to fail.

**Example**

```bash
tctl activity fail --activity_id <id>
```

### --reason

Specify the reason for failing an [Activity Execution](/activities#activity-execution).

**Example**

```bash
tctl activity fail --reason <value>
```

### --detail

Specify details of the reason for failing an [Activity Execution](/activities#activity-execution).

**Example**

```bash
tctl activity fail --detail <value>
```

### --identity

Specify the identity of the operator when using tctl to fail an [Activity Execution](/activities#activity-execution).

**Example**

```bash
tctl activity complete --identity <value>
```
